home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 1995 July & August / cd No4 joystick No62.iso / mac / pc / CADEAUX / 3D / 3DS2IM.DOC next >
Text File  |  1995-05-10  |  7KB  |  169 lines
  1. ------------------------------------------------------------------------------
  2.     3DS2IM.EXE - 3DS to Imagine object converter - READ.ME Document
  3. ------------------------------------------------------------------------------
  4.  
  5. This document describes the above mentioned program and gives
  6. other general information.
  7.  
  8. ------------------------------------------------------------------------------
  9.                 DESCRIPTION
  10. ------------------------------------------------------------------------------
  11.  
  12.   3DS2IM converts 3DS binary object files to Imagine format for use
  13. with Imagine modeling/animation software from Impulse, Inc.  
  14.  
  15. ------------------------------------------------------------------------------
  16. GENERAL NOTES
  17. ------------------------------------------------------------------------------
  18.  
  19. - 3DS2IM is shareware.  Please, register it if you use it on regular
  20.   basis.  Registration will entitle you to a special upgrade to the 
  21.   3D converter/viewer program which is currently is development.  By
  22.   registering it, you will be supporting the shareware authors and
  23.   shareware concept itself, which provides inexpensive, quality
  24.   programs as an alternative to overpriced retail items.
  25.  
  26. - DOS4GW.EXE, included with this distribution, is a DOS extender.  It
  27.   allows 3DS2IM to use your extended memory.  Many 3DS files are very
  28.   large and contain many objects.  DOS4GW overcomes the 640K limit of
  29.   DOS and lets you use all the memory for conversion.
  30.  
  31. - Imagine currently imposes a 32K limit on the number of faces, edges
  32.   vertices (32K each).  Consequently, 3DS files which contain objects
  33.   with more than 32K of vertices, edges or faces will not be
  34.   converted by the shareware version.  Registered version will split 
  35.   large objects into several smaller ones and group them together.
  36.  
  37. - Unregistered version will convert only first 25 objects in the 3DS file.
  38.  
  39. - All the converted objects are grouped to a single axis located at
  40.   origin.  To ungroup them, PICK the axis and press Alt-Y.
  41.  
  42. ------------------------------------------------------------------------------
  43. Registration
  44. ------------------------------------------------------------------------------
  45.  
  46.  The registered version will:
  47.     
  48.     1. Split large objects into smaller ones for use in Imagine.
  49.  
  50.     2. Handle more than 25 objects.
  51.  
  52.     3. List objects in 3DS file and allow you to choose which one to
  53.            convert.
  54.  
  55.     4. Entitle you to free upgrades and a special upgrade to a 
  56.        3D converter/viewer program currently in development.
  57.  
  58.     5. Give you peace of mind. :->
  59.  
  60. ------------------------------------------------------------------------------
  61.                 HOW TO REGISTER
  62. ------------------------------------------------------------------------------
  63.  
  64.   To register this copy of 3DS2IM converter, print out the
  65. REGISTER.FRM, fill it in, and send it with your check or money order
  66. to the address on the form.  The registered version will be sent to you
  67. either by e-mail or on a disk if you desire.
  68.  
  69. ------------------------------------------------------------------------------
  70.                     SUPPORT
  71. ------------------------------------------------------------------------------
  72.              
  73.   My schedule tends to change a lot, so if you don't reach me by the
  74. phone, leave a message, I'll get back to you as soon as possible.
  75. Alternatively, use E-mail.
  76.  
  77.   To contact me, call (402) 423-1337. If the phone number changes,
  78. use e-mail or I will try to contact you if you have registered.
  79.  
  80.   Your best chance of reaching me is on Compuserve or Internet.  You
  81. can also find the latest version of 3DS2IM converter in GUGRPA forum.
  82.  
  83.   Compuserve ID: 73021,66
  84.   Internet: zmievski@herbie.unl.edu
  85.  
  86.   If you have found a bug or a technical problem, don't hesitate to
  87. contact me.
  88.  
  89. ------------------------------------------------------------------------------
  90.                    FUTURE ENHANCEMENTS    
  91.  ------------------------------------------------------------------------------
  92.  
  93.   *  Full support of hierarchy
  94.  
  95.   *  Conversion of surface properties.
  96.  
  97.   *  Possible support of RAW and 3DFACE DXF formats.
  98.  
  99.   *  Imagine to 3DS conversion (only if I get enough registrations to
  100.      buy 3DS file toolkit from Autodesk.  If that happens, you can
  101.      count on full conversion to and from 3DS files including textures,
  102.      morphing, and probably animation.  Please, register.)
  103.  
  104.   *  Integration into my 3D converter/viewer program with friendly
  105.      GUI interface and many cool features.
  106.  
  107. ------------------------------------------------------------------------------
  108.                 KNOWN BUGS
  109. ------------------------------------------------------------------------------
  110.  
  111.   NONE
  112.  
  113. ------------------------------------------------------------------------------
  114.                 HOW TO USE 3DS2IM
  115. ------------------------------------------------------------------------------
  116.  
  117.   To run 3DS2IM you have to have both 3DS2IM.EXE and DOS4GW.EXE in
  118. your path or current directory.  3DS2IM will *not* run withour
  119. DOS4GW.EXE.
  120.  
  121.   Usage:  3DS2IM <input>[.3ds] [output[.iob]] [/v]
  122.  
  123.   <input> is the name of the 3DS file you wish to convert.  If you
  124. don't type in the .3DS extension, 3DS2IM will add it for you.
  125.  
  126.   <output> is the name of the output Imagine file that 3DS2IM
  127. creates.  If you don't provide it, the name of the input file plus
  128. extension .IOB will be used.  If you don't provide an extension for
  129. the output file, .IOB will be added to it.
  130.  
  131.   /v - turns on verbose mode.  In verbose mode, 3DS2IM prints out
  132. addtional information as it processes the file.  The information
  133. includes face and vertex count for each object.
  134.  
  135.   NOTE: 3DS2IM will not convert objects that are composed only of
  136.         vertices and do not have faces.  These objects are
  137.     degenerate indicated by "Object has no faces" line after the
  138.         name of the object.
  139.  
  140.   If you see a line that says "Object is too complex.", it means that
  141. the objects has over 32K of vertices, edges or faces and will not be
  142. converted by shareware version.
  143.  
  144.   Examples:
  145.      
  146.     3DS2IM iris /v            Convert iris.3ds to iris.iob in
  147.                     verbose mode.
  148.  
  149.     3DS2IM chevy.3ds chevy.grp     Convert chevy.3ds to chevy.grp
  150.                     in quiet mode.
  151.  
  152. ------------------------------------------------------------------------------
  153.                   IMPORTANT INFORMATION
  154. ------------------------------------------------------------------------------
  155.  
  156.   3DS2IM converter is NOT a public domain program.  It is Copyright (c) 1995
  157. by Andrey Zmievskiy.  All rights reserved.
  158.  
  159.   This software and accompanying documentation are protected by
  160. United States Copyright law and also by International Treaty
  161. provisions. 
  162.  
  163.   The Shareware evaluation (trial use) version is provided AS IS.
  164. Andrey Zmievskiy makes no warranty of any kind, expressed or
  165. implied, including without limitation, any warranties of
  166. merchantability and/or fitness for a particular purpose.
  167.  
  168.  
  169.             Thank you for using 3DS2IM!